Routines (alphabetical) > Routines: H > HDF Routines > HDF_VD_GETINFO

HDF_VD_GETINFO

The HDF_VD_GETINFO procedure is a general VData inquiry routine. Set the various keywords to named variables to return information about each field of a VDatain a HDF file.

Syntax

HDF_VD_GETINFO, VData, Index [, NAME=variable] [, ORDER=variable] [, SIZE=variable] [, TYPE=variable]

Arguments

VData

The VData handle returned by a previous call to HDF_VD_ATTACH.

Index

A zero-based index specifying which field or the name of the field within the VData to inquire about. For example:

HDF_VD_GETINFO, Vdat, 'VEL', ORDER=order

Keywords

NAME

Set this keyword to a named variable in which the name of the field is returned as a string.

ORDER

Set this keyword to a named variable in which the order of the field is returned.

SIZE

Set this keyword to a named variable in which the size of a data value for the specified field in the VData is returned.

TYPE

Set this keyword to a named variable in which the type of the field is returned. One of the following strings is returned: 'BYTE', 'INT', 'LONG', 'FLOAT', 'DOUBLE'.

Examples

HDF_VD_GET, Vdat, NFIELDS=n

FOR index=0,n-1 DO BEGIN

  HDF_VD_GETINFO, Vdat, index, NAME=n, TYPE=t, ORDER=o

  PRINT, index, ':', n, 'TYPE=', t, 'ORDER=', o

ENDFOR

Version History

 

4.0

Introduced